WHAT IS CLAIMED 



1 1 . Interfaces, embodied on one or more computer-readable media, to be 

2 called on kernel transaction management objects, comprising: 

3 application program interfaces (APIs) to implement operations on a kernel 

4 transaction obj ect (TX) ; 

5 APIs to implement operations on a kernel resource management object 

6 (RMO); and 

7 APIs to implement operations a kernel enlistment (EN) object. 

1 2. Interfaces according to Claim 1, wherein each of the APIs to 

2 implement operations on TX, RMO, and EN utilize a handle to refer to an object. 

1 3. Interfaces according to Claim 2, wherein each of the handles is an 

2 opaque reference to a unique object. 

1 4. Interfaces according to Claim 2, wherein at least one API calls for 

2 TX to transmit pre-prepare messages to resource managers associated with a transaction. 

1 5. Interfaces according to Claim 2, wherein at least one API calls for 

2 TX to transmit a prepare request to resource managers enlisted in a transaction. 

1 6. Interfaces according to Claim 2, wherein at least one API calls for a 

2 new TX to be created for a transaction. 
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1 7. Interfaces according to Claim 2, wherein at least one API calls for an 

2 existing TX to be opened for a transaction. 

I 

1 8. Interfaces according to Claim 2, wherein at least one API calls for 

2 TX to commit a transaction. 

1 9. Interfaces according to Claim 2, wherein at least one API calls for 

2 TX to abort a transaction. 

1 10. Interfaces according to Claim 2, wherein at least one API calls for 

2 TX to save a current state of the transaction. 

1 11. Interfaces according to Claim 2, wherein at least one API calls for 

2 TX to retrieve information about the TX for a requestor. [ 

1 12. Interfaces according to Claim 2, wherein at least one API calls for 

2 TX to set information. , 

1 13. Interfaces according to Claim 2, wherein at least one API calls for j 

i 

2 TX to close. ' 

I 

I 
j 

1 14. Interfaces according to Claim 2, wherein at least one API is: 

2 PreprepareEnlistment, i 

3 PrepareEnlistment, 
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4 OpenEnlistment 

5 CreateTransaction, 

6 OpenTransaction, 

7 CommitTransaction, 

8 RollbackTransaction, 

9 SavepointTransaction, 

10 GetTransactionlnfo, and 

1 1 SetTransactionlnfo. 

1 15. Interfaces according to Claim 2, wherein at least one API calls for a 

2 new RMO to be created. 

1 16. Interfaces according to Claim 15, wherein the new RMO is volatile. 

1 17. Interfaces according to Claim 1 5, wherein the new RMO is durable. 

1 18. Interfaces according to Claim 2, wherein at least one API calls for an 

2 existing RMO to open for a transaction. 

1 19. Interfaces according to Claim 2, wherein at least one API calls for 

2 RMO to be destroyed. 

1 20. Interfaces according to Claim 2, wherein at least one API calls for 

2 RMO to transmit information regarding RMO to a requestor. 
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1 21. Interfaces according to Claim 2, wherein at least one API calls for 

2 RMO to set information. 



1 22. Interfaces according to Claim 2, wherein at least one API calls for 

2 RMO to be enlisted on a transaction at least once. 

1 23. Interfaces according to Claim 2, wherein at least one API calls for a 

2 notification from a resource manager for RMO. 

1 24. Interfaces according to Claim 2, wherein at least one API is: 

2 CreateResourceManager, 

3 OpenResourceManager, 

4 DestroyResourceManager, 

5 GetResourceManagerlnfo, 

6 SetResourceManagerlnfo, 

7 CreateEnlistment, and 

8 GetNotificationResourceManager. 

1 25. Interfaces according to Claim 2, wherein at least one API is to 

2 implement operations on TX by RMO. 

1 26. Interfaces according to Claim 25, wherein the at least one API is to 

2 inform TX that pre-preparing is complete. 
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1 27. Interfaces according to Claim 25, wherein the at least one API is to 

2 inform TX that transaction preparation has been completed by a requested resource 

3 manager. 

1 28. Interfaces according to Claim 25, wherein the at least one API is to 

2 inform TX that a resource manager has completed rolling back a transaction. 

1 29. Interfaces according to Claim 25, wherein the at least one API is to 

2 inform TX that a resource manager has committed to a transaction. 



1 30. Interfaces according to Claim 25, wherein the at least one API is: 

2 PrePrepareComplete, 

3 PrepareComplete, 

4 RoUbackComplete, and 

5 CommitComplete. 

1 31. Interfaces according to Claim 2, wherein at least one API calls for a 

2 resource manager to be registered as a communications resource manager for a particular 

3 protocol. 

1 32. Interfaces according to Claim 2, wherein at least one API calls for a 

2 representation of a transaction to be serialized into a buffer. 
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1 33. Interfaces according to Claim 2, wherein at least one API calls for 

2 information representing registered protocols to be serialized into a buffer. 



1 34. Interfaces according to Claim 32, wherein at least one API calls for a 

2 transaction represented by the serialization be made available by a transaction 

3 management object. 

1 35. Interfaces according to Claim 2, wherein at least one API calls for a 

2 transaction to be propagated to a destination using push-style propagation. 

1 36. Interfaces according to Claim 35, wherein at least one API calls for 

2 the output of the API calls for the transaction to be propagated to a destination using 

3 push-style propagation to be retrieved. 

1 37. Interfaces according to Claim 31, wherein at least one API is called 

2 when transaction propagation has been completed. 

1 38. Interfaces according to Claim 31, wherein at least one API is called 

2 when requested transaction propagation has failed. 

1 39. Interfaces according to Claim 2, wherein at least one API is: 

2 RegisterProtocolAddressInformation, 

3 MarshallTransaction, 

4 GetProtocolAddressInformation, 
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5 PuUTransaction, 

6 PushTransaction, 

7 PushTransactionBuffer, 

8 PropagationComplete, and 

9 PropagationFailed. 

1 40. An apparatus for implementing a transaction, comprising: 

2 a kernel transaction object (TX); 

3 a kernel resource manager object (RMO); and 

4 a kernel enlistment object (EN), 

5 wherein two-phase commit processing is executed by calling APIs on the 

6 TX, the RMO, and the EN. 

1 41 . A transaction method for a kemel transaction object, comprising: 

2 receiving a call to open; 

3 transmitting a call to prepare for a transaction; 

4 receiving a call confirming prepare complete; 

5 transmitting a call indicating an outcome of the transaction; and 

6 receiving a call confirming receipt of the call indicating the outcome of the 

7 transaction. 

1 42. A method according to Claim 41, wherein the call to open is 

2 received from a client application. 
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1 43. A method according to Claim 41, wherein the call to prepare is 

2 transmitted to resource managers enlisted on a transaction. 

1 44. A method according to Claim 43, wherein the call to prepare 

2 suppHes a handle for the transaction to be prepared for, and supplies a handle to the 

3 kernel transaction object. 

1 45. A method according to Claim 41, wherein the call confirming 

2 prepare complete is received from a resource manager enlisted on the transaction. 

1 46. A method according to Claim 45, wherein the call confirming 

2 prepare complete includes a handle indicating the transaction for which the prepare 

3 operation has been completed. 

1 47. A method according to Claim 41, wherein the call indicating the 

2 outcome of the transaction is transmitted to a resource manager enlisted on the 

3 transaction. 

1 48. A method according to Claim 41, further comprising receiving a call 

2 to be committed to the transaction. 

1 49. A method according to Claim 48, wherein the call to be committed 

2 to the transaction supplies a pointer to a location that will receive a handle to the 
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3 transaction, supplies a mask specifying a desired level of access, and supplies a pointer to 

4 an optional object attribute structure. 

1 50. A method according to Claim 41, further comprising receiving a call 

2 to abort the transaction. 

1 51. A method according to Claim 50, wherein the call to abort the 

2 transaction supplies a handle indicating the transaction to be aborted. 

1 52. A transaction method for a kemel resource management object, 

2 comprising: 

3 receiving a call to prepare a resource for a transaction; 

4 transmitting a call confirming prepare complete; 

5 receiving a call indicating an outcome of the transaction; and 

6 transmitting a call confirming receipt of the call indicating the outcome of 

7 the transaction. 

1 53. A method according to Claim 52, wherein the call to prepare is 

2 received from a transaction object. 

1 54. A method according to Claim 53, wherein the call to prepare 

2 includes a handle for the transaction to be prepared for, and supplies a handle to the 

3 transaction object. 
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1 55. A method according to Claim 53, wherein the call confirming 

2 prepare complete is transmitted to a transaction object. 

1 56. A method according to Claim 55, wherein the call confirming 

2 prepare complete supplies a handle indicating the transaction for which the prepare 

3 operation has been completed. 

1 57. A method according to Claim 52, wherein the call indicating the 

2 outcome of the transaction is received from a transaction object. 

1 58. A method according to Claim 52, further comprising transmitting a 

2 call indicating the transaction has been aborted. 

1 59. A method according to Claim 58, wherein the call indicating the 

2 transaction has been aborted is transmitted to a transaction object, and supplies a handle 

3 indicating the transaction for which the abort has been completed. 

1 60. A method according to Claim 52, further comprising transmitting a 

2 call indicating the transaction has been committed. 

1 61. A method according to Claim 60, wherein the call indicating the 

2 transaction has been committed is transmitted to a transaction object, and supplies a 

3 handle indicating the transaction for which the commit has been completed. 
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1 62. A method according to Claim 52, further comprising setting resource 

2 data in accordance with the outcome of the transaction. 

1 63. A computer-readable medium on which are stored one or more 

2 functions, calls for the one or more functions causing a kernel transaction object to: 

3 open a transaction object; 

4 transmit a prepare call; 

5 receive a prepare complete call; 

6 transmit a call indicating an outcome of the transaction; and 

7 receive a call indicating receipt of the call indicating the outcome of the 

8 transaction. 

1 64. A computer-readable medium according to Claim 63, wherein the 

2 call to open the transaction object is received from a client application. 

1 65. A computer-readable medium according to Claim 63, wherein the 

2 prepare call is transmitted to resource managers enlisted on a transaction. 

1 66. A computer-readable medium according to Claim 63, wherein the 

2 call confirming prepare complete is received from a resource manager enlisted on the 

3 transaction. 
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1 67. A computer-readable medium according to Claim 63, wherein the 

2 call indicating the outcome of the transaction is transmitted to a resource manager 

3 enlisted on the transaction. 

1 68. A computer-readable medium according to Claim 63, further 

2 comprising a call causing the kemel transaction object to be committed to the transaction. 

1 69. A computer-readable medium according to Claim 63, further 

2 comprising a call causing the kemel transaction object to abort the transaction. 

1 70. A computer-readable medium on which are stored one or more 

2 functions, calls for the one or more functions causing a kemel resource management 

3 object to: 

4 prepare a resource for a transaction; 

5 transmit a call confirming prepare complete; and 

6 set resource data in accordance with an outcome of the transaction. 

1 71. A computer-readable medium according to Claim 70, wherein the 

2 call to prepare a resource for the transaction is received from a transaction object. 

1 72. A computer-readable medium according to Claim 70, wherein the 

2 call confirming prepare complete is transmitted to a transaction object. 
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1 73. A computer-readable medium according to Claim 70, wherein a call 

2 indicating the outcome of the transaction is received from a transaction object. 

1 74. An apparatus for implementing a transaction, comprising: 

2 means for representing a transaction; and 

3 means for representing a relationship between the means for representing a 

4 transaction and a resource participating in the transaction, 

5 wherein two-phase commit processing is executed by calling APIs between 

6 the means for representing a transaction and the means for representing a relationship. 
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